home *** CD-ROM | disk | FTP | other *** search
/ Especial Multimedia / Especial Multimedia.iso / Multimed / Visuali / SBJV1624.ZIP / JVIEW.DOC < prev    next >
Text File  |  1997-06-05  |  15KB  |  333 lines
  1. SBJV: Jpeg Image Viewer 
  2.  
  3. (C) Scott M Baker 
  4.  
  5. -------------------------------------------------------------------------------
  6.  
  7. Purpose: 
  8.  
  9. The purpose of this program is to display jpeg, bmp, tga (and possibly other) 
  10. image files on your computer screen. Several special features are included, 
  11. such as a slideshow mode, ability to stretch images to fit full screen, and a 
  12. visual picture index. 
  13.  
  14. This program is designed to be a companion to SBNews/Newsbot, my nntp download 
  15. & decode program, although SBNews is not necessary for operation of SBJV. 
  16.  
  17. -------------------------------------------------------------------------------
  18.  
  19. Requirements: 
  20.  
  21.     * Windows 3.1 or greater 
  22.  
  23. Distribution: 
  24.  
  25.     * 16-bit (Windows 3.1) Version: SBJV16xx.ZIP (xx denotes version number)
  26.     * 32-bit (Windows 95) Version: SBJV32xx.ZIP (xx denotes version number
  27.  
  28. Features:
  29.  
  30.     * Slideshow mode: Display images automaticly onscreen. Can be set to 
  31.       forward, reverse, or random order. 
  32.     * Encrypted Images: You may encrypt your image files with the enclosed 
  33.       ENCRYPT.EXE utility and use SBJV to view the encrypted files, protecting 
  34.       them from undesired viewers. 
  35.     * Visual Index: a 4x4 scrollable grid of thumbnail images -- useful to find 
  36.       a picture when you don't know the name, or as an overview of your image 
  37.       collection 
  38.     * One-click file categorization. 
  39.  
  40. Files Included: 
  41.  
  42.     * JVIEW.EXE: Executable; what you need to run to get the program to work. 
  43.     * JVIEW.HTM: Documentation in HTML format (read with your browser) 
  44.     * JVIEW.DOC: Documentation in plain-ASCII format (read with any plain ascii 
  45.       text editor) 
  46.     * BWCC.DLL (16-bit) or BWCC32.DLL (32-bit): Borlands Custom-Control DLL 
  47.       library; used to support SBJV's grey dialog boxes. 
  48.     * FILE_ID.DIZ: Brief description file; useful for bbs distribution 
  49.     * REGISTER.HTM: Registration info in HTML format 
  50.     * REGISTER.DOC: Registration info in plain-ASCII format 
  51.     * README.1ST: General information on documentation & archives 
  52.     * ENCRYPT.EXE: Standalone utility, Used to encrypt files on disk 
  53.     * DECRYPT.EXE: Standalone utility, Used to decrypt files on disk 
  54.  
  55. -------------------------------------------------------------------------------
  56.  
  57. Installing and Using the Program: 
  58.  
  59. Here are some very quick notes on installing and using SBJV: 
  60.  
  61. Installation: 
  62.  
  63.    1. Unzip the distribution archive into the directory of your choice. 
  64.  
  65. Running: 
  66.  
  67.    1. Run JVIEW.EXE -- this can be done in various ways - from the Win-95 
  68.       command prompt, the Windows Explorer (and/or file manager), the Windows 
  69.       Run Program command, etc. 
  70.    2. Along the right hand side will be a directory and file listing. You may 
  71.       double-click entries in the directory listing to change working 
  72.       directories, or double click filenames in the file list to view an image 
  73.    3. The "Index" button may be used to open up the visual index. 
  74.  
  75. -------------------------------------------------------------------------------
  76.  
  77. Visual Index Mode
  78.  
  79. The visual index mode may be accessed by pushing the Index button while you are 
  80. in a directory containing pictures. When activated, it will display a grid of 
  81. thumbnail images, which are generated automatically by SBJV based on the images 
  82. in the current directory. 
  83.  
  84. Double clicking on any image will cause the large viewer to display the image. 
  85.  
  86. -------------------------------------------------------------------------------
  87.  
  88. One-Click Categorization
  89.  
  90. SBJV was designed to allow easy one-click categorization of images. To use the 
  91. categorization features, do the following: 
  92.  
  93.    1. Under the "Options" pull-down menu, select "Display Categorization Pane". 
  94.       This will enable a vertical panel along the right side of the screen. 
  95.    2. On the categorization panel, use the "Add/Edit" button to add new 
  96.       categories to the list. For each category, type in the category name and 
  97.       the physical directory location. 
  98.    3. Once you have finished setting up your categories, you may click on any 
  99.       category to automatically move the current image to that location. 
  100.  
  101. -------------------------------------------------------------------------------
  102.  
  103. Command Line Parameters
  104.  
  105.     * "-i INI_FILE_NAME". Sets the name of the INI file to use. By default, 
  106.       SBJVuses the file newsbot.ini in your windows directory. Specifying a 
  107.       filename here will cause newsbot to use the file under that name in 
  108.       newsbot's home directory. For example "JView -i jview1.ini" would use the 
  109.       filename "news1.ini" in newsbot's home directory. 
  110.     * "-noabout". Omits display of the about dialog on startup of SBJV. Note: 
  111.       Only supported in registered version!
  112.     * You can also place a single filename on the command line to cause jview 
  113.       to load that filename. For example, "jview c:\myfile.jpg" would load and 
  114.       display the file c:\myfile.jpg. 
  115.  
  116. -------------------------------------------------------------------------------
  117.  
  118. Catalog Generation
  119.  
  120. What are they?
  121.  
  122. SBJV includes a catalog image generator. Catalog images are images that contain 
  123. a collection of thumbnails. They are useful in case you wish to distribute a 
  124. summary of your collection of images to another user. For example, catalogs are 
  125. used widely in binary picture newsgroup to give an overview of a selection of 
  126. pictures before they are uploaded. 
  127.  
  128. How do you generate them?
  129.  
  130. The option to generate catalogs is located under the File menu in the main 
  131. window of SBJV. First go into the directory you wish to generate the catalogs 
  132. from. Then, select "Generate Catalogs" from the file menu. You will be 
  133. presented with a rather complex dialog box of options. Most of these are 
  134. already set to the default values and need not be altered. Click on "Ok". Your 
  135. catalogs will be placed in your SBJV/SBNews directory (unless you have 
  136. specified otherwise). 
  137.  
  138. What are all those complicated options?
  139.  
  140. There are several options that control the output of the catalogs. Most are set 
  141. to defaults and need not be modified. Here is a descriptive listing: 
  142.  
  143.     * Background Style. This controls the background appearance of the catalogs 
  144.       (i.e. the area that is not covered by the thumbnails). Several different 
  145.       styles are available depending on your personal preference. 
  146.           * Raised Groupbox / Sunken Groupbox. These simulate a 3-dimensional 
  147.             box around each image. The background color is automatically chosen 
  148.             to be light gray. 
  149.           * Flat Gray / Flat Black / Flat White. These are pure colors. 
  150.           * Tiled "Blend" of image. This takes another image (specified in the 
  151.             blend field) and tiles it for use as the background. The effect is 
  152.             similar to how MS-Windows can tile an image for wallpaper on your 
  153.             desktop. 
  154.           * Stretched "Blend" of image. This takes another image (specified in 
  155.             the blend field) and stretches it to fill the background. Aspect 
  156.             ratio is not preserved, so some images may not look right in this 
  157.             perspective. 
  158.     * Blend Filename. This is the name of the file that will be blended into a 
  159.       background if you specified Tiled/Stretched blend as the background style 
  160.       above. Any JPG/GIF/BMP file will work. 
  161.     * Thumbnail Image Properties. 
  162.           * Center image in box. This causes each thumbnail image to be 
  163.             centered within it's box rather than aligning it to the upper left 
  164.             corner. 
  165.           * Fast integer scaling. Causes images to be scaled to a multiple of 
  166.             1/2, 1/4, or 1/8. The image will probably not fill the whole box in 
  167.             this case. You probably should NOT check this option unless you 
  168.             have a good reason for doing so. 
  169.     * Output File Path. This specifies the path to which output files will be 
  170.       written. It defaults to the directory in which SBJV/SBNews was loaded. 
  171.     * Output File Name. This is the name of each catalog file. Do NOT specify a 
  172.       path or extention for the filename. The extention "jpg" will 
  173.       automatically be added. Catalog numbers will also be added automatically. 
  174.     * Cat-Number padding. This controls how numbers are represented in the 
  175.       filename. This is best shown by example: 
  176.           * No Padding: example "cat1.jpg", "cat2.jpg", ..., "cat99.jpg" 
  177.           * Pad 1 digit: example "cat1.jpg", "cat2.jpg", ..., "cat99.jpg" 
  178.           * Pad 2 digits: example "cat01.jpg", "cat02.jpg", ..., "cat99.jpg" 
  179.           * Pad 3 digits: example "cat001.jpg", "cat002.jpg", ..., "cat099.jpg" 
  180.     * Initial Cat-Num. This is the starting number for the catalog filenames. 
  181.       You can start it anywhere you'd like, but "1" is usually a good bet. 
  182.     * Output Image Size. This specifies the resolution of the catalog files. 
  183.       You may choose anything you like -- larger resolutions offer better 
  184.       quality and/or more images per page, but require a higher resolution 
  185.       display to view them fullsize. 800x600 or 1024x768 is usually a good 
  186.       choice. 
  187.     * Number of Columns. The number images across a page from left to right. 
  188.     * Number of Rows. The number of images down a page from top to bottom. 
  189.  
  190. There is also a button called "Annotate" which will let you configure a header 
  191. (text across the top of a page) and a footer (text across the bottom of a page) 
  192. to be added to the catalogs. This is a good place to put a title or copyright 
  193. information. 
  194.  
  195. -------------------------------------------------------------------------------
  196.  
  197. Acknowledgements 
  198.  
  199. I would like to thank the following people for their help, support, or 
  200. contributions to SBNews/Newsbot and SBJV: 
  201.  
  202.     * The many people who've helped me beta-test! 
  203.     * The Independent JPEG Group 
  204.     * The ISO Jpeg Standards Committee 
  205.     * Brian Kantor & Phil Lapsley (RFC977) 
  206.     * S. Barber (NNTP Extensions document) 
  207.     * The Papa winsock site 
  208.     * The Tucows winsock site 
  209.     * Lars Magne Ingebrigtsen, "Notes on News" 
  210.  
  211. -------------------------------------------------------------------------------
  212.  
  213. Registration 
  214.  
  215. SBJV is a shareware program and as such, you are only granted the right to 
  216. operate it for a limited time to evaluate it's performance. Continued usage 
  217. requires registration in the amount of $15.00. 
  218.  
  219. For information on registration, please see REGISTER.DOC (or REGISTER.HTM). 
  220.  
  221. -------------------------------------------------------------------------------
  222.  
  223. Contacting Me
  224.  
  225. US-Mail: 
  226.  
  227. Scott M. Baker
  228. 2241 W Labriego
  229. Tucson, Az 85741
  230. United States of America
  231.  
  232. My Bulletin board: 
  233.  
  234. The Not-Yet-Named BBS
  235. (520) 544-4655 (USR Dual 14.4k)
  236. (520) 797-8573 (USR Sportster 28.8k)
  237.  
  238. Email: 
  239.  
  240. smbaker@primenet.com
  241.  
  242. My Homepage: 
  243.  
  244. http://www.primenet.com/~smbaker
  245.  
  246. Find the latest SBNews/Newsbot at this address: 
  247.  
  248. http://www.primenet.com/~smbaker/sbnews/sbnews.html 
  249.  
  250. Find the latest SBJV at this address: 
  251.  
  252. http://www.primenet.com/~smbaker/sbjv/sbjv.html 
  253.  
  254. -------------------------------------------------------------------------------
  255. Revision History
  256.  
  257.     * Version 1.0 
  258.           * Split SBJV from SBNews to form a standalone utility 
  259.           * Initial public release 
  260.     * Version 1.1 
  261.           * Fixed problem with 256-color mode 
  262.           * Fixed File:Exit command causing crash (well, it did exit!) 
  263.           * Fixed scrollbars shutting off when scrolled all the way down 
  264.           * Added categorization system to jpeg viewer 
  265.           * Toggles for categorization and directory panes 
  266.     * Version 1.2 
  267.           * Changed ICON to reflect program name 
  268.           * Misc small bug fixes 
  269.     * Version 1.3 
  270.           * 32-bit packing in 32-bit version 
  271.           * Documentation update for categorization & visual index modes 
  272.           * Fixed abort problem in unregistered about dialog 
  273.           * Added stretch to min(Window,Fullsize) option to jpeg viewer 
  274.           * Added center option to jpeg viewer 
  275.           * Made Jpeg picture viewer background gray 
  276.           * Eliminated flicker when resizing JPeg viewer 
  277.           * Spiffed up appearance of Jpeg and Index windows with gray 
  278.             background 
  279.           * Added file marking options to jpeg viewer 
  280.           * Added "only display marked files" option to slideshow 
  281.           * Made move and delete handle marked batches of files 
  282.     * Version 1.4 
  283.           * Fixed problem with jpeg viewer delete button causing crash 
  284.           * Added Next and Previous menu items to Jpeg viewer menu 
  285.           * Added keyboard shortcuts for next and previous items in Jpeg viewer 
  286.           * Fixed tabbing problems in jpeg viewer somewhat 
  287.           * Mouse click+drag can be used to scroll images in jpeg viewer 
  288.           * Fixed JPeg viewer categorization pane getting messed up when window 
  289.             resize 
  290.           * Improved GrayStatic control; Eliminated unneccessary repaint of 
  291.             full control 
  292.     * Version 2.0 
  293.           * Added automatic lookahead to Jpeg viewer 
  294.           * Maybe fixed a memory leak while viewing GIF/BMP files 
  295.           * Set literal strings in code segment option in 16-bit version (save 
  296.             dseg space) 
  297.           * Added print command to jpeg viewer 
  298.           * Added generate catalogs command to jpeg viewer 
  299.           * Added context sensitive help to several dialog boxes 
  300.           * Added splitter to Jpeg Window to allow resizing of file/dir pane 
  301.           * Added horizontal scrollbars to Jpeg Window file/dir pane 
  302.           * Raised maximum number of Jpeg categories to 75 
  303.           * Categorization pane will automatically go multi-column if necessary 
  304.     * Version 2.1 
  305.           * Fixed GPF in 16-bit version due to insufficient stack space 
  306.           * Changed JView path storage to use a variable rather than system 
  307.             wide cwd so one JView window won't interfere with another's path 
  308.           * Fixed help file problem if program not loaded from directory with 
  309.             help file+ 
  310.     * Version 2.2 
  311.           * Spiffed up overwrite dialog box 
  312.           * Added optional filename argument to command line 
  313.           * Fixed -noabout command line switch which wasn't working 
  314.     * Version 2.3 
  315.           * Added join directories command to jpeg viewer 
  316.           * Jpeg viewer can now load bmp's with less than 256 colors 
  317.           * Added additional information to jpeg viewer overwrite messagebox 
  318.     * Version 2.4 
  319.           * Fixed padding in catalog generation (wasn't doing anything) 
  320.           * Added padding=4 to catalog generation 
  321.           * Added quality setting to catalog generation 
  322.           * Added additional error checking to blend name on generate catalogs 
  323.             dialog 
  324.           * Added voice registration nag 
  325.           * Added zoom command to jpeg viewer 
  326.           * Fixed jpeg viewer zoom ratio changing as picture is panned/scrolled 
  327.           * Reduced initial SBJV/SBIMG shareware delay to 5 seconds 
  328.           * Added Encrypt and Decrypt commands to jview menu 
  329.           * Fixed help in Win-3.1 version 
  330.           * Image viewer support for .FTS/.FITS telescope image files 
  331.  
  332.  
  333.